home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / drtrk105.zip / DOORTRAK.DOC < prev    next >
Text File  |  1993-01-14  |  5KB  |  170 lines
  1.  
  2.  
  3.                 DOORTRAK v1.5
  4.  
  5.                 By Wayne Gay
  6.                Thee Landing Z*O*N*E BBS
  7.                   256:100/3@MXBBSNET
  8.                    1:3401/5@FIDONET
  9.                   1-206-336-5915(bbs)
  10.                  Mt. Vernon, Washington
  11.  
  12.  
  13.  
  14. Description:
  15.  
  16.     Doortrak is a simple program. It will keep track of the number 
  17.     of times a door is entered. Also it will keep track of door users
  18.     and how many doors they have entered.
  19.     It does this with a call from the door calling batchfile.
  20.     Has been tested using the Xtern_dos and the Xtern_erlvl calls from
  21.     Menus.ctl.
  22.  
  23. Setup:
  24.  
  25.     Setup is fairly simple. I will try to give examples where possible.
  26.  
  27.     First thing you'll need to do is edit the DOORTRAK.CFG to your suit
  28.     your needs. The Sample included in this archive explains the setup
  29.     for the configuration.
  30.  
  31.     In the directory with DOORTRAK Type : DOORTRAK SETUP
  32.  
  33.     SETUP PROGRAM: is now automated with the doortrak.cfg file...
  34.  
  35.  
  36. Usage:
  37.  
  38.     Using the program is almost as simple as the setup.
  39.     
  40.    Using the Xtern_Dos exit from Maximus:
  41.  
  42.     In the batch file for the door, either before the door is run or 
  43.     after it's done running Change the current directory to the directory
  44.     with doortrack.exe.
  45.     then call doortrak with the door code as the paramater, 
  46.     
  47.     IE: ( door calling batch file example )
  48.  
  49.     ...... 
  50.     
  51.     cd \rgdoor         ( change to the door directory )
  52.     rgdoor             ( run the door )
  53.     cd\bbs             ( change to the directory doortrak is in )
  54.     doortrak rgd       ( Run DOORTRAK with "rgd" as the paramater )
  55.     ......             ( go on to bbs )
  56.      
  57.  
  58.    Using the Xtern_erlvl exit from Maximus:
  59.  
  60.     In the bbsbatch file you need to call DOORTRAK in the door subroutine
  61.     either before or after the door is run.
  62.      
  63.     IE: ( bbscalling batch file example )
  64.  
  65.     ......
  66.  
  67.     :rgdoor            
  68.     cd\rgdoor          ( change to the door directory )
  69.     rgdoor             ( run the door )
  70.     cd\bbs             ( change to the directory doortrak is in )
  71.     doortrak rgd       ( Run DOORTRAK with "rgd" as the paramater )
  72.     ......             ( go on to bbs )
  73.  
  74.  
  75. Bulletin Maker:
  76.  
  77.     The bulletin maker can be run after each door or in the nightly 
  78.     maint. ( I suggest the nightly, but it's up to you ).
  79.  
  80.     After Each Door is Run:
  81.  
  82.     Simply run DOORTRAK with the bulletin paramater after the call 
  83.     with the door code.
  84.     
  85.     IE:
  86.     .....
  87.     doortrak bulletin
  88.     ..... 
  89.  
  90.     !!REMEMBER!! This creates a MECCA style file. To View it in Maximus,
  91.     you'll need to compile it with MECCA.
  92.  
  93.     In The Nightly Maint.:
  94.  
  95.     Simply change to the directory DOORTRAK is in, and run DOORTRAK 
  96.     with the bulletin paramater. 
  97.     
  98.     IE:
  99.     .....
  100.     cd\bbs           
  101.     doortrak bulletin
  102.     mecca c:\bbs\misc\bulletin.mec
  103.     ..... 
  104.  
  105.  
  106. Resetting the Counters:
  107.  
  108.     This will clear the counters for the doors as well as the users.
  109.     it will ask you if you really want to do it before it will clear 
  110.     them.
  111.     This feature is for those of us who want to reset them on a monthly
  112.     basis.( Or weekly or whenever..)
  113.  
  114.     IE:     ( Example call to reset the counters )
  115.  
  116.     doortrak reset
  117.  
  118.  
  119.     .....     !!!  NEW feature  !!!!
  120.  
  121. Adding doors:
  122.  
  123.        This feature will allow you to add new doors to the existing list,
  124.        without losing data on the old doors. No more need to reset 
  125.        everything to add new doors to the list.
  126.  
  127.        All you need to do is add the door information( as stated above )
  128.        to the "END" of the list of doors in your doortrak.cfg file.
  129.        Make sure the new doors follow the old doors. You can add as many
  130.        as you'd like up to the maximum.
  131.        Once you've added the proper lines to the .cfg file then type:
  132.        
  133.        doortrak dooradd
  134.  
  135.        Thats all there is to it...
  136.  
  137.  
  138. Limitations:
  139.  
  140.     This program is currently capable of handling up to 100 doors
  141.     and 1000 users. I expect this to be large enough. Don't worry if
  142.     you have more than 1000 users, unless they all use the doors,
  143.     The program only adds the doorusers names to the database as 
  144.     they use them, without duplicating any of them.
  145.  
  146. Registration:
  147.  
  148.     Since I put my time into the building and ever improving of this
  149.     program, I feel a small fee should be payed for it's continued
  150.     use. So I ask you to send me $5.00, in return, I'll send you a
  151.     registration key, which will show registered in the bulletin, as
  152.     well as enable the function to adjust the length of the bulletin.
  153.  
  154.  
  155. Please report all bugs to me via netmail at the addresses above.
  156.  
  157. This is my first public release of any type of program. I'm not a professional
  158. programmer, just a self-taught hobbyist. So please bear with me through the
  159. initial phases of this release.
  160.  
  161. ANY SUGGESTIONS for the improvement of this program will be gladly looked 
  162. into. 
  163.  
  164. Enjoy (I hope) this program....
  165.  
  166.  
  167. Thanks to Brian Pirie for the use of his Registration Key System Version 2.20
  168.  
  169.  
  170.